.. _ecmSxCmpOne_SetHandler:

ecmSxCmpOne_SetHandler
======================
----------------------


SYNOPSIS
--------


.. code-block:: none

  t_success  ecmSxCmpOne_SetHandler(
    t_i32  NetID,
    t_i32  Axis,
    t_f64 HandlerType,
    HANDLE  Handler,
    UINT  nMessage,
    LPARAM  lParam,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 이 함수는 ‘One-shot’ 모드에서 이벤트 통지를 위한 핸들러를 설정하는 함부입니다.



PARAMETER
---------


- NetID : Network 번호

- Axis : 대상 축 번호.

- :ref:`HandlerType  <ecat_enum_EEcmHandlerType>`  : 이벤트 핸들러 타입

- Handler : 이벤트 핸들러(HandlerType에 따라 Window Handle, Event 객체, Callback 함수)

- nMessage : Window Message 방식일 경우, 사용자 정의 메시지

- lParam : Window Message 방식일 경우, 사용자 정의 메세지 파라미터. Callback 함수일 경우, 함수 파라미터

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 이 리턴값은 불 형(Boolean Type) 을 가지고 있습니다.



+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+